Managing Test Cases
Designer > Test Cases is the central repository for test cases for all your models. From here, you can:
- Find and view an existing test case
- Create a test case from scratch or duplicate an existing one
- Edit a test case
- Delete a test case
- Run test cases
- View the results of the last 10 runs for a test case
- View the summary of all results for a test case
- Export a list of test cases for your records
See Building Test Cases to learn how to create your first test case.
Find and View a Test Case
All existing test cases are displayed on the Test Cases page in alphabetical order. Just click on a test case name to preview it.
To narrow down the list to find a specific test case or group of test cases, either:
- Enter full or partial test case names in the search box.
- Select the model that the test cases belong to.
Along with the name of the test case, and the model it belongs to, the following details are displayed:
- Origin: The source of the test case. For example, another test application or auditing system.
- External ID: The unique identifier for the test case in the external system.
- Tags: Any tags specified for the test case. Tags are useful for identifying test cases, and associated test results, that belong to a particular category or feature.
- Last 10 Runs: Latest 10 run results of the test case when it is used in a Live Run or Test Config, represented by a set of different-colored dots.
- Last Run: Latest date and time when the test case is used in a Live Run or Test Config
Add a New Test Case
Create a new test case from scratch or reuse an existing test case.
Create a New Test Case
Follow these instructions to create a new model from scratch.
- From Test Cases, click Add New +.
- Follow the instructions in Building Test Cases.
Duplicate a Test Case
To save time, reuse elements from existing test cases instead of recreating them. This is particularly useful when sharing test cases with other team members, for debugging, and taking backups.
- Go to Test Cases and find the test case that you're interested in.
- From the actions menu on the test case, select Duplicate.
- In the Test Case box, enter a name for your new test case. Do not include any of the following characters:
" \ ; , : { }
. - Click Create. Your new test case is ready to update.
Edit a Test Case
When you want to return to an existing test case to update it:
- Go to Test Cases and find the test case that you're interested in.
- From the actions menu on the test case, select Edit. Your test case is ready to update.
Delete a Test Case
When making changes to your model, you might need to update or even remove a test case.
- Go to Test Cases and find the test case that you want to remove.
- From the actions menu on the test case, select Delete.
Run Tests Cases Against a Model
You can manually run test cases at any time.
- Go to Test Cases and find the test case that you want to execute.
- From the actions menu on the test case, select Run. The Live Run page opens with your test case. This page will give the option to run a scripted or model based test case.
View the Results of the Last 10 Runs for a Test Case
After running a test case against a model or suite, you can view the results of up to the 10 most recent runs. Each run result is represented by a colored dot, which can be clicked for more information.
-
Go to Test Cases and locate the test case that you are interested in.
-
If the test case has any completed runs, you will see a row of colored-dots under the Last 10 Runs column.
-
The dots are arranged chronologically from left to right so that the latest run is at the right.
-
Each color of the dots represents a run status:
- Teal: Success
- Orange: Error
- Red: Fail
- Grey: Cancelled
- Purple: In Progress
-
Click on any of the dots to display additional results for the test run.
View the Summary of all Results for a Test Case
You can easily view the success metrics for an individual test case, and then drill down into each test run for further information.
-
Go to Test Cases and find the test case that you're interested in.
-
On the test case, select to view a chart of the number of passed and failed runs for the selected test case.
-
Click View All Results to show details of each test run in date order.
Export a List of Test Cases
For reference or auditing, you can export the list of test cases shown on the Test Cases page as a .csv
file.
From Test Cases, click Export All. A .csv
file of test case details is downloaded.